home *** CD-ROM | disk | FTP | other *** search
/ Nothing but Tetris / Nothing but Tetris.iso / tools / amiga / fastgif / usversion / fastgif2.doc < prev    next >
Encoding:
Text File  |  1993-06-27  |  11.5 KB  |  405 lines
  1.  
  2.                               FastGIF II V1.08
  3.                     (c) 1992,93 by Christophe PASSUELLO
  4.                    -------------------------------------
  5.  
  6.  
  7.     FastGIF II is The GIF viewer. This new version has been rewritten, now
  8.     there is a real user interface, a file-requester, gadgets, and also
  9.     short-cut, now you can display picture in a screen as before and in a
  10.     WorkBench window, Multiple select is now implemented. FastGIF II takes
  11.     advantage of the new AGA chipset. It's always the FASTEST GIF viewer on
  12.     Amiga.
  13.  
  14.  
  15.     FastGIF II is now SHAREWARE, so if you use it often send me a contribution
  16.     of 10 US$ or 50 French Francs (bills only), you will receive the registered
  17.     version of FastGIF II with IFF saving. If you live out Europa add 4 US$
  18.     or 20 French Francs for mailing.
  19.  
  20.  
  21.     FastGIF can't be sold alone or in any package, but you can freely
  22.     distribuate it on PD's disks (like Fred Fish one) or on any BBS only if
  23.     complete and unmodified. Distribution of registered version is FORBIDEN.
  24.  
  25.  
  26.  
  27. DISCLAIMER
  28. ----------
  29.  
  30.   The author isn't responsable of any damages resulting of FastGIF II use.
  31.  
  32.   Before starting FastGIF II, you must be sure to have the Reqtools.library
  33.   and the iff.library (for registered version) in your LIBS: directory.
  34.  
  35.  
  36. PRESENTATION
  37. ------------
  38.  
  39.      FastGIF II displays pictures with more than 32 colors using gray-scale,
  40.   and using color if the picture don't have move than 32 colors. If you own
  41.   a new Amiga with AGA chipset (A1200 & A4000), display will use colors even
  42.   with a 256 colors picture. It allows now multiple selection for slide-show.
  43.  
  44.   There is still some little problems with AGA chipset, when you use hires
  45.   switch during display the image may looks strange, these little problems
  46.   will be fixed as soon as i will receive docs about the new libraries of
  47.   WorkBench 3.0.
  48.  
  49.  
  50.  
  51. FEATURES
  52. --------
  53.  
  54.   - Now with a user interface, file-requester, iconify and so on.
  55.  
  56.   - Very fast, mains routines are written using very highly optimised assembler
  57.     (twice faster than TurboGIF).
  58.  
  59.   - It should be even faster with 32 bits cards because the assembly routines
  60.     are small enough to fit in the cache. (I suggest you to set on the cache
  61.     instruction using CPU or SetCPU).
  62.  
  63.   - It displays GIF89a files.
  64.  
  65.   - It works on NTSC or PAL.
  66.  
  67.   - You can scroll picture.
  68.  
  69.   - It handles corrupted GIF files.
  70.  
  71.   - Completly multitasking.
  72.  
  73.   - Multiple select for slide-show.
  74.  
  75.  
  76.  
  77. RUNNING FASTGIF II WITH CLI
  78. ---------------------------
  79.  
  80.     Usage: FastGIF [-low] [-aga] -[agif] [-noreq] [-icon]
  81.  
  82.     -low      This can you help when you are low on memory, with this option
  83.               you can display a 640*512 picture with 512 KB CHIP and 512 KB
  84.               FAST. (May slow down decompression).
  85.  
  86.     -aga      Set this flag if you have a new Amiga with AGA chipset.
  87.  
  88.     -agif     Set this flag if the GIF pictures came from Amiga. It is used
  89.               to do a better guess of picture ratio. If the flag is not set
  90.               then FastGIF will use 1.3 as ratio aspect.
  91.  
  92.     -noreq    If you don't want requesters.
  93.  
  94.     -icon     Minimal use of memory when iconified.
  95.  
  96.  
  97.    You can set these options in FastGIF II using the Options Requester.
  98.  
  99.  
  100.  
  101. RUNNING FASTGIF II WITH WORKBENCH
  102. ---------------------------------
  103.  
  104.    Just double-click on the FastGIF II 's icon. You can set the following Tools
  105.    Types before running (With Info item of WorkBench menu).
  106.  
  107.     LOWMEM=ON      This can you help when you are low on memory, with this
  108.                    option you can display a 640*512 picture with 512 KB CHIP
  109.                    and 512 KB FAST. (May slow down decompression).
  110.  
  111.     CHIPAGA=ON     Set this flag if you have a new Amiga with AGA chipset.
  112.  
  113.     AMIGAGIF=ON    Set this flag if the GIF pictures come from Amiga. It is
  114.                    used to do a better guess of picture ratio.
  115.  
  116.     ICONNFREE=ON   Minimal use of memory when iconified.
  117.  
  118.     NOREQUESTER=ON If you don't want requesters.
  119.  
  120.    See Options Requester for more information.
  121.    These options can be set in FastGIF II using the Options Requester.
  122.  
  123.  
  124.  
  125. HOW TO USE FASTGIF II
  126. ---------------------
  127.  
  128.   Once loaded, you can see 6 buttons and two text areas, the small one gives
  129.   information about the current file, the big one tells what FastGIF II is
  130.   doing. Underlined letter are short-cut.
  131.  
  132.  
  133. I BUTTON LOAD
  134. -------------
  135.  
  136.    Opens a file-requester, if you choose a file it will be loaded in ram and
  137.    decompressed, picture size and so on will be printed on Information area.
  138.    You can now select more than one file, just press SHIFT key when clicking
  139.    on a filename. (You can also use the "All" or "Match" gadget).
  140.  
  141.    If you wait until the file requester has scanned all the directory, the
  142.    next time you won't have to wait: the directory will be in the buffer.
  143.  
  144.  
  145. II BUTTON VIEW
  146. --------------
  147.  
  148.    If the option No Requester isn't set, it opens a window with viewing options:
  149.  
  150.     - You can choose between a screen and a WorkBench window for displaying
  151.       pictures. If you choose the WB window, the WorkBench must have enough
  152.       colors else the picture will be converted in gray-scale if the WorkBench
  153.       has at least 16 colors. With this mode 256 colors graphics cards that
  154.       emulate WorkBench may works (Tell me if it works)
  155.  
  156.     - For screen display you can choose hires, interlace and overscan. Usually
  157.       you don't need to use this flags, since FastGIF set them regarding the
  158.       picture size.
  159.  
  160.     - For gray-scale converted picture you can choose brightness and contrat.
  161.       Contrast can greetly improve the quality of picture (a value of 15 is
  162.       usually enough).
  163.  
  164.  
  165.    * Once the screen is displayed you can use the following keys:
  166.  
  167.      L      : switch Interlace
  168.      H      : switch Hires
  169.      O      : switch Overscan
  170.      ESC    : close the screen
  171.  
  172.     To scroll picture use cursor keys, with SHIFT scrolling will use 16 pixels
  173.     step, with ALT you to go to border of the screen. Click on right mouse
  174.     button to close the screen.
  175.  
  176.  
  177.    * Using WB window:
  178.  
  179.      You can change window size, use scroller to scroll picture in window,
  180.      using the CloseWindow gadget or ESC key you will close window.
  181.  
  182.  
  183.   NOTE: If more than one file has been selected, FastGIF goes directly to
  184.         next file (Slide-show).
  185.  
  186.  
  187. III BUTTON SAVE
  188. ---------------
  189.  
  190.    WARNING! IFF saving is only available with registered version.
  191.  
  192.     A requester let you choose options:
  193.  
  194.      - You can choose to save the picture with all its colors (Without
  195.        conversion) or to convert picture to gray-scale (contrast and bright-
  196.        ness are those used in VIEW part.)
  197.  
  198.      - Compression tells if you want to compress pictures, no compression is
  199.        useful if you power-pack pictures.
  200.  
  201.     A filerequester let you choose the filename. If more than one file has been
  202.     selected and the No Requester option's it set then all files will be saved
  203.     into the save directory of the first file. (".IFF" will be added at the end
  204.     of the filename (".GIF" will be replaced by ".IFF")). 
  205.  
  206.    NOTE: the picture is saved with a 24 bits palette.
  207.  
  208.  
  209. IV BUTTON ABOUT
  210. ---------------
  211.  
  212.    Tells some info about FastGIF II.
  213.  
  214.  
  215. V BUTTON OPTIONS
  216. ----------------
  217.  
  218.    This will allow you set FastGIF II options:
  219.  
  220.     - 256 Colors must be set to use 256 colors modes (You must have AGA chipset
  221.       or may be a 256 colors graphic card).
  222.  
  223.     - Low memory may help you if you are low in memory.
  224.  
  225.     - Will free memory used by current file when iconified, so once iconifed
  226.       FastGIF II will only use 40 KBytes of memory.
  227.  
  228.     - Set Amiga pictures flags if your GIF files come from Amiga. It is
  229.       used to do a better guess of picture ratio.
  230.  
  231.     - If No Requester is set, the View options are set by FastGIF and the
  232.       picture is displayed directly.
  233.  
  234.  
  235. IV ICONIFY
  236. ----------
  237.  
  238.    Just iconify FastGIF II.
  239.  
  240.  
  241.  
  242. TO DO
  243. -----
  244.  
  245.   - Using colors instead of grey-scale for pictures with more than 32 colors. ?
  246.  
  247.   - Double buffering ?
  248.  
  249.  
  250. AUTHOR
  251. ------
  252.  
  253.    Send me any suggestion, bugs-report, flames, donations, etc....
  254.    I'am looking for docs about the graphics.library to use 24 bits palette,
  255.    to look for avaible display mode (sources, examples, includes and LVOs),i 'm
  256.    also looking for the last version of Reqtools (>= V38) for improve this
  257.    viewer.
  258.    I'm looking also for docs about PCX, PIC and BMP or other format to write a
  259.    multi-format viewer.
  260.  
  261.    For bugs-report send informations about your config:
  262.    FastGIF version, witch processor, version of Workbench, how many RAM you
  263.    own (CHIP & FAST), ...
  264.  
  265.  
  266.    You can contact me at the following address:
  267.  
  268.         Christophe PASSUELLO
  269.         25, Rue du Plateau
  270.         91600 SAVIGNY SUR ORGE
  271.         FRANCE
  272.  
  273.  
  274.  
  275. CREDITS
  276. -------
  277.  
  278.   * FastGIF II uses the great ReqTools.library, copyright (c) by Nico Franτois.
  279.   * Iconify routine based on Iconify by Leo L. Schwab (available on Fred Fish
  280.     Disk 126).
  281.   * GIF Format is Copyright (c) CompuServe Incorporated.
  282.   * iff.library is Copyright (c) Christian A. WEBER.
  283.   * Thanks to Thierry Andeol and Arto Ikola for beta-testing and suggestions.
  284.  
  285.  
  286. HISTORY
  287. -------
  288.  
  289.  - RELEASE V1.00
  290.  
  291.       First release
  292.  
  293.  
  294.  - RELEASE V1.02
  295.  
  296.       Decompression 5% faster.
  297.       Bug fixed : ScrollVPort doesn't works very well with Interlaced. I use
  298.       MakeScreen and ReThinkDisplay instead.
  299.  
  300.  
  301.  - RELEASE V1.10
  302.  
  303.       Now can display pictures with more than 32 colors in gray-scale.
  304.       Pictures are now centered in the middle of the screen.
  305.  
  306.  
  307.  - RELEASE V1.11
  308.  
  309.       Internal release.
  310.       Fast scrolling added.
  311.  
  312.  
  313.  - RELEASE V1.12
  314.  
  315.       New algorithm for decompression: 25 % FASTER.
  316.  
  317.  
  318.  - RELEASE V1.13
  319.  
  320.       Bug fixed: palette colors wasn't good.
  321.  
  322.  
  323.  - RELEASE V1.14   (Sep 15 1992)
  324.  
  325.       -low option added.
  326.  
  327.  
  328.  - VERSION V1.20   (Oct 1 1992)
  329.  
  330.       GIF parsing completly rewritten, much safer than before.
  331.       Now support GIF89a files.
  332.       Options for contrast and brightness added.
  333.       GIFInfo added to the archive.
  334.  
  335.  
  336.  - VERSION FASTGIF II V1.00   (Jan 31 1993)
  337.  
  338.       Completly rewritten version.
  339.       Now FastGIF II is SHAREWARE.
  340.       Intuition User Interface added (Gadgets, requester, iconification).
  341.       There is now a filerequester.
  342.       Viewing routine rewritten.
  343.       You can now view pictures in a Workbench window.
  344.       You can run FastGIF II from WorkBench
  345.       LZW decompressing 68020+ version added.
  346.       Now supports the new AGA chips.
  347.       IFF saving added (with registered version).
  348.  
  349.  
  350.  - VERSION FASTGIF II V1.01   (Feb 04 1993)
  351.  
  352.       Now cut corrupted part of the picture.
  353.       Small bug in the text area fixed.
  354.  
  355.  
  356.  - VERSION FASTGIF II V1.02   (Feb 23 1993)
  357.  
  358.       No more pointer when displaying pictures.
  359.       A larger FileRequester.
  360.  
  361.  
  362.  - VERSION FASTGIF II V1.03   (Feb 28 1993)
  363.  
  364.       Removing pointer in V1.02 has brought a bug: now fixed.
  365.  
  366.  
  367.  - VERSION FASTGIF II V1.04   (Mar 11 1993)
  368.  
  369.       A bug fixed for 8 colors pictures.
  370.       Now, once the GIF file is loaded, the view flags hires, interlace and
  371.       overscan are set regarding picture size.
  372.  
  373.  
  374.  - VERSION FASTGIF II V1.05   (Mar 23 1993)
  375.  
  376.       Multiple select added.
  377.       Option "No Requester" added.
  378.  
  379.  
  380.  - VERSION FASTGIF II V1.06   (Mar 28 1993)
  381.  
  382.       Tool Types NOREQUESTER and ICONNFREE added.
  383.       Best hires, lace, overscan flags guess.
  384.       A small bug fixed when un-iconify.
  385.  
  386.  
  387.  - VERSION FASTGIF II V1.07   (Apr 21 1993)
  388.  
  389.       Amiga GIF flag added.
  390.       Now check if GIF file before load it in memory.
  391.       Added flags for command line.
  392.  
  393.  
  394.  - VERSION FASTGIF II V1.08   (Jun 17 1993)
  395.  
  396.       Best AGA support (Use 64 bits aligned width bitmap, 24 bits palette).
  397.       Now support any fontsize.
  398.       Small bugs fixed.
  399.  
  400.  
  401.                        -------------
  402.  
  403.  
  404.                         Enjoy FastGIF !!!!!!!!!!!
  405.